═══ 1. Introducing SnapDump/2 ═══ IBM SnapDump/2 This tool is an IBM RAS (Reliability, Availability, and Serviceability) tool developed by IBM United States Software Services. You will typically use this tool to automatically collect information about your workstation. Analysis of this information will help speed problem determination by your service representative. ═══ 2. Special Notices ═══ References in this information to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any of IBM's intellectual property rights or other legally protectible rights may be used instead of the IBM product, program, or service. Evaluation and verification of operation in conjunction with other products, programs, or services, except those expressly designated by IBM, are the user's responsibility. IBM may have patents or pending patent applications covering subject matter in this information. The furnishing of this information does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Commercial Relations, IBM Corporation, Purchase, NY 10577. The following terms, denoted by an asterisk (*) in this information, are trademarks of the IBM Corporation in the United States and/or other countries: FASTService First Failure Support Technology/2 FFST/2 IBM Operating System/2 OS/2 Personal System/2 Presentation Manager PS/2 SAA SnapDump/2 Systems Application Architecture. The following paragraph does not apply to the United Kingdom or any country where such provisions are inconsistent with local law. INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS INFORMATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information at any time. It is possible that this information may contain reference to, or information about, IBM products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that IBM intends to announce such IBM products, programming, or services in your country. Requests for copies of this information and for technical information about IBM products should be made to your IBM Authorized Dealer or your IBM Marketing Representative. (C) Copyright International Business Machines Corporation 1991. All rights reserved. Note to US Government Users : Documentation and programs related to restricted rights. Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. ═══ 3. Command Syntax ═══ The syntax of the SnapDump/2 interface is: SNAPDUMP [input_command_file] [output_dump_file] where: o input_command_file is the optional name of an input command file that will be read to determine what data should be collected. o output_dump_file is the optional name of the output dump file. ═══ 3.1. Input command file format ═══ The actions of SnapDump/2 are governed by a command file. Here is a sample command file: f/config.sys f/syslevel.* f/startup.cmd f/*.ini f/log0001.dat f/os2mlog.dat f/acs.pro f/*.hst f/*.log m/\SHAREMEM\ACS\RAS_SEG f/NET.ERR p/NET STATISTICS REQUESTER p/NET STATISTICS SERVER p/NET STATUS p/NET ERROR p/NET TIME p/NET VIEW p/NET WHO p/pstat.exe p/dir c:\ p/dir c:\os2\system where -- o A 'p' in column 1 indicates that the named program is to be executed and any output to the standard output handle (1) and standard error handle (2) are to be captured. Any programs (including .CMD files) that can be run from the OS/2 command prompt and that write to standard output and/or standard error may be specified. The output of programs that use other techniques of writing to the screen, such as Presentation Manager "Win" calls or "VIO" calls, cannot be captured. o A 'f' in column 1 indicates that a files are to be captured. Standard wildcards may be specified, but be aware that the SnapDump may become too large if too broad a file specification is given. o A 'm' in column 1 indicates that a named shared memory "file" ("\SHAREMEM\...") is to be captured. Wildcards are not allowed. Certain named shared memory segments are protected and cannot be dumped. The names of the named shared memory files in your system may be obtained by issuing the command "PSTAT /M" at the OS/2 command prompt. o Any other byte in column one causes the line to be treated as a comment. ═══ 4. Output dump file ═══ At the completion of a SnapDump, the file name of the SnapDump will be displayed. SnapDumps should be directed to a drive with enough free disk space. The drive may be a network drive, a local fixed disk drive, a floppy drive, or a virtual disk drive. ═══ 5. Formatting the SnapDump ═══ The SnapDump Dump Formatter, SNAPDF.EXE , is used to view the SnapDump. This formatter is a Presentation Manager application that allows you to display, print, and save to a file selected portions of the SnapDump. You may also enter the name of the dump file on the command line, i.e. SNAPDF XXX.DMP.